home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr30 / vrow121.zip / VGAROW.DOC < prev    next >
Text File  |  1993-05-22  |  13KB  |  287 lines
  1. Documentation for VgaRow.Exe last revision is 05-22-1993 for version 1.21.
  2. Produced by Patrick T. Wolfert, (c) Copyright 1993. All Rights Reserved.
  3.  
  4.  
  5.  
  6.  
  7. What is VgaRow?
  8.  
  9. VgaRow.Exe is a program which may be executed from the DOS Config.Sys file
  10. as a device driver or from the DOS command prompt as a standard executable
  11. file to change the number of rows currently being displayed by a VGA
  12. adapter on either a color or monochrome monitor.
  13.  
  14.  
  15.  
  16.  
  17. Why use VgaRow?
  18.  
  19. Use VgaRow when you want to change the number of text rows being displayed
  20. on your computer's monitor. It will let you change rows to either 50, 43,
  21. 28, 25, 21, 14, or 12 rows with or without clearing the screen.
  22. You may want to change this for a whole host of reasons:
  23.         1. Reduce eye strain.
  24.         2. Prevent Config.sys initialization messages from scrolling off
  25.            of the screen before they can be read; This is the reason why
  26.            I wrote the device driver part of the program which came first.
  27.         3. Confuse network snooper programs which transmit an image of the
  28.            screen back to another node on the network, with or without the
  29.            knowledge of the person being viewed. The NetBIOS program at an
  30.            office where I have worked tosses cookies to the viewer for any
  31.            number of rows other than 25.
  32.         4. Setting up nice looking small OS/2 2.0 DOS windows without
  33.            having any scroll bars around to muck them up.
  34.         5. You want to see more of that spreadsheet you have been working
  35.            on but even just the thought of that 132 column mode and it's
  36.            tiny characters makes your eyes cross.
  37.         6. Same as 5 but the 132 column mode is not supported or does not
  38.            look nice in some graphical environment you are working in.
  39.        (7. A place for the ones I didn't think of.)
  40.  
  41.  
  42.  
  43. What is VgaRow compatible with?
  44.  
  45. VgaRow requires that the host computer have a VGA adapter and a BIOS which
  46. supports the basic VGA functions of setting the scan lines, mode, and font.
  47. VgaRow has an option which disables VGA detection for those video adapters
  48. which are capable of some of the modes such as the EGA adapter which should
  49. be able to run 43 or 21 rows fine.
  50. VgaRow has been tested with MS DOS 3.2, IBM DOS 3.3, IBM DOS 4.01,
  51. IBM DOS 5.0, and IBM OS/2 2.0 GA using a DOS Window or a
  52. Virtual DOS Machine and has been found to work in all cases either when
  53. loaded as a device driver or when invoked from the command prompt.
  54. It has been tested on both ISA and EISA based PCs having either a Diamond
  55. Stealth VRAM, or an Orchid ProDesigner VGA graphics adapter.
  56. It has been tested (and developed) under QuarterDeck's DesqView which does
  57. not toss any cookies but may or may not change the mode depending on how DV
  58. and it's windows are set up and the position of the sun. It has not been
  59. tested under MicroSoft Windows at all.
  60. VgaRow's code is complied for the 8086 meaning that it will run on any
  61. 80x86 based computer or close compatible.
  62.  
  63.  
  64.  
  65.  
  66. DOS compatibility notes:
  67.  
  68. Versions of DOS previous to version 5 (maybe 4) do not detect the number of
  69. rows on the screen dynamically when programs such as Dir /p or More need to
  70. know when to pause. DOS 3.3 for example seems to always think there is only
  71. 25 rows no matter how many or few there really are. IBM DOS 5 processes
  72. Dir /p and More correctly no matter how many rows are set.
  73.  
  74. The device driver and executable format should be good for DOS 2 and up
  75. but I have read that some versions of DOS 2 do not have the executable
  76. file loader present at the time Config.Sys is processed so .EXE files
  77. cannot be in Config.Sys. My program will not work under those conditions.
  78.  
  79.  
  80.  
  81.  
  82. OS/2 2.0 compatibility notes:
  83.  
  84. VgaRow.Exe works in any regular OS/2 DOS Command window or full screen
  85. session or any window or full screen session of a Virtual DOS Machine. I
  86. have tested only VDM's booted from image files but have tested images of
  87. IBM DOS 3.3 and IBM DOS 5.0 and both allow VgaRow to be used in any
  88. invokation. VgaRow makes nice 14 row DOS windows which can be maximized and
  89. then have a small font applied to them yielding a scroll bar free window
  90. of a small height streching across the screen. I find it quite useful for
  91. the commands that require it.
  92.  
  93.  
  94.  
  95.  
  96. The Disclaimer (copied from another shareware project I completed):
  97.  
  98. This software carries ABSOLUTLY NO warranty whatsoever, this program
  99. works on the author's system and is not guaranteed to work on anyone
  100. else's system. The owner/author, Patrick T. Wolfert, will not be held
  101. liable for ANY damages caused by this program to any system.  If you are
  102. in doubt as to this program's suitability for your system then simply
  103. do not run it!
  104.  
  105.  
  106.  
  107. The License:
  108.  
  109. This program is not free, it is distributed as shareware, meaning that
  110. you are encouraged to try it out on your own system and upload it to as
  111. many systems as you would like to, but that after a reasonable trial
  112. period not to exceed one month of use you are required to pay for it's
  113. continued use.
  114. Payment is ten dollars ($10) per computer which will have it's screen
  115. rows modified by VgaRow payable in United States currency.
  116.  
  117. Please remit to:
  118.         Patrick T. Wolfert
  119.         580 Main Street, Suite 1320
  120.         New York, N.Y., 10044
  121.  
  122. Multiple computer licensing information is available upon request.
  123. If desired, I will send the latest or next copy of the program and
  124. documentation files to your address if it is supplied. Any license granted
  125. will apply to all versions of VgaRow which have not yet been released.
  126.  
  127.  
  128.  
  129.  
  130. Instructions:
  131.  
  132. VgaRow may be loaded from either the Config.Sys file or from the DOS
  133. command prompt. VgaRow requires NO resident memory; Loading as a device
  134. driver is simply a convenience to prevent messages from scrolling off
  135. of the screen on computers which process many programs within their
  136. Config and Autoexec files.
  137.  
  138. VgaRow may also be executed from other programs; LoadHi /GS indicates
  139. that 2576 run-time bytes of memory are used by VgaRow 1.21.
  140.  
  141. VgaRow will always display a message indicating it's processing status.
  142.  
  143.  
  144. To invoke VgaRow from your Config.Sys file add a line consisting of the
  145. following anywhere in the file where you want the screen rows to change:
  146.  
  147.         DEVICE=[d:][path]VgaRow.Exe [options]
  148.  
  149. Replace the [d:] with an optional drive specification, the [path] with
  150. an optional path specification and [options] with any options you may
  151. wish to pass to Vgarow to modify it's execution. Do not place the VgaRow
  152. invokation in between any device commands which must load consecutively.
  153.  
  154.  
  155. To invoke VgaRow from the command line type the following:
  156.  
  157.         [d:][path]VgaRow [options]
  158.  
  159. Replace the [d:] with an optional drive specification, the [path] with
  160. an optional path specification and [options] with any options you may
  161. wish to pass to Vgarow to modify it's execution.
  162.  
  163.  
  164.  
  165. Options available to modify the operation of VgaRow:
  166.  
  167. Options to VgaRow are typed after it's invokation. Options are not case
  168. sensitive and consist of a row count or short word or abbrieviation.
  169. Options may be typed in any order; If multiple conflicting options are
  170. present then only the last applicable one is used since it's values
  171. will overwrite any set by previous options.
  172.  
  173. Option          Function
  174. ?               VgaRow does nothing but display a quick syntax message.
  175. 50              VgaRow will set the adapter to display 50 rows.
  176.                 This is the default number of screen rows.
  177. 43              VgaRow will set the adapter to display 43 rows.
  178. 28              VgaRow will set the adapter to display 28 rows.
  179. 25              VgaRow will set the adapter to display 25 VGA rows.
  180. 25V             VgaRow will set the adapter to display 25 VGA rows.
  181. 25E             VgaRow will set the adapter to display 25 EGA rows.
  182. 25C             VgaRow will set the adapter to display 25 CGA rows.
  183. 21              VgaRow will set the adapter to display 21 rows.
  184. 14              VgaRow will set the adapter to display 14 rows.
  185. 12              VgaRow will set the adapter to display 12 rows.
  186. NoCls           VgaRow will not clear the screen.
  187.                 This is the default for screen clearing.
  188. Cls             VgaRow will clear the screen and 'home' the cursor.
  189. +               Enable VGA detect. This is the default.
  190. -               Disable VGA detect.
  191.                *Results are undefined for non-VGA adapters.
  192.  
  193. N and C may be used in place of NoCls and Cls respectively.
  194.  
  195. Examples follow:
  196.  
  197. Device=c:\util\Vgarow.exe           Change rows to 50 without clearing.
  198. Device=c:\util\Vgarow.exe Cls 28    Change rows to 28, clear screen.
  199. VgaRow ?                            Display a help message only.
  200. VgaRow 43 -                         Display 43 rows, no clear screen,
  201.                                     disable VGA detection.
  202.  
  203.  
  204.  
  205.  
  206. Usage notes:
  207.  
  208. I do not have a monochrome VGA monitor to test this program with so
  209. the special monochrome code is untested at this time. If you use this
  210. program with monochrome VGA please let me know how it turns out. The
  211. differences for monochrome are that screen mode 3 is used instead of 7
  212. and the program message colors should be plain white. No video card
  213. I tested this with was capable of emulating monochrome so that my
  214. program (or any other for that matter) could detect it properly.
  215.  
  216. If you are using a display page other than page zero as the active page
  217. the program will probably reset the screen to page zero as the active
  218. page. I do not know this for sure and have not tested it under this
  219. condition.
  220.  
  221. The only place in OS/2 2.0 that I have not invoked it from is the device
  222. line of the DOS settings for a regular OS/2 DOS session.
  223.  
  224. The difference between the CGA, EGA, and VGA 25 row modes is the number
  225. of scan lines put on the screen. Each is visibly different.
  226.  
  227. The program requires about 3K of memory and switches to an internal stack
  228. for both device driver and DOS EXEC execution.
  229.  
  230.  
  231.  
  232.  
  233. Author's notes:
  234.  
  235. This program is written in 8086 Assembler. It was assembled using
  236. XASM, The Brand X Assembler by Access, a very very good assembler
  237. compatible with MASM, so compatible it probably could never be released.
  238. Thank-you to whoever wrote it!
  239.  
  240. In May of 1991 I typed in a debug script from what I think was PC Magazine.
  241. In a letter to the editor there was a small 21 byte COM file which set
  242. the screen to 28 rows. I thought that it was pretty cool and learned more
  243. about the video services. While learning about the video services I saw
  244. that other row counts were possible. In December 1992 after getting a
  245. new video adapter I made a 50 row version of the 21 byte file which got me
  246. wondering if it could be done in Config.Sys so that I would not miss
  247. any messages output by programs starting up in Config or Autoexec.
  248. Recently I had some time to do this and so VgaRow was born. It was started
  249. on May 15, 1993, some hours later the first device driver version gave my
  250. screen 50 rows. Quarterdeck's Device program was very useful since I could
  251. test my program in a Desqview window without having to reboot my computer
  252. every time the program freaked out (developing device drivers tend to do
  253. that). After the program was stable I decided to make an .EXE out of the
  254. .SYS version which would load both ways and operate using the same syntax.
  255. The program grew to many many times the size of the original .SYS version
  256. but added many features such as picking the rows and choosing the screen
  257. clearing option. Now it probably takes less space than two separate
  258. programs would take.
  259. The first version to be released to the public is VgaRow version 1.21 of
  260. May 21, 1993.
  261.  
  262.  
  263.  
  264. Questions, Comments, Suggestions, or Criticisms?
  265.  
  266. They are all welcome, send them all to me at:
  267.         Patrick T. Wolfert
  268.         580 Main Street, Suite 1320
  269.         New York, N.Y., 10044
  270.  
  271. Hopefully VgaRow can help to make using your computer more efficient
  272. and enjoyable than it otherwise would have been.
  273.  
  274.  
  275.  
  276.  
  277. Copyrights, Trademarks, and other protections:
  278.  
  279.         Desqview is property of Quarterdeck Office Systems.
  280.         IBM DOS is property of IBM Corporation.
  281.         LoadHi is property of Quarterdeck Office Systems.
  282.         MS DOS is property of MicroSoft Corporation.
  283.         OS/2 is property of IBM Corporation.
  284.         VgaRow is property of Patrick T. Wolfert.
  285.  
  286.                                    - Fini -
  287.